Inside Macintosh: QuickTime Components /

Chapter 3 - Standard Image-Compression Dialog Components / Standard Image-Compression Dialog Components Reference

Standard Image-Compression Dialog Component Functions / Compressing Still Images

SCCompressImage

The SCCompressImage function compresses an image that is stored in a pixel map.

pascal ComponentResult SCCompressImage (ComponentInstance ci,
                                    PixMapHandle src, 
                                    Rect *srcRect,
                                    ImageDescriptionHandle *desc, 
                                    Handle *data);

ci

Identifies your application's connection to a standard image-compression dialog component.

src

Contains a handle to the pixel map to be compressed.

srcRect

Contains a pointer to a portion of the pixel map to compress. This rectangle must be in the pixel map's coordinate system. If you want to compress the entire pixel map, set this parameter to nil.

desc

Contains a pointer to an image description handle. The standard dialog component creates an image description structure when it compresses the image, and returns a handle to that structure in the field referred to by this parameter. The component sizes that handle appropriately. Your application is responsible for disposing of that handle when you are done with it.

data

Contains a pointer to a handle. The standard dialog component returns a handle to the compressed image data in the field referred to by this parameter. The component sizes that handle appropriately. Your application is responsible for disposing of that handle when you are done with it.

RESULT CODES

scUserCancelled

1

Dialog box canceled--user clicked Cancel

Image Compression Manager errors (from FCompressImage function)

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help